Release 10.1A: OpenEdge Development:
ADM Reference

callstring.p procedure

External procedure that allows for a single RUN statement to invoke a call using a string that defines the parameters. The procedure is useful for minimizing the number of requests it takes to invoke a call on the AppServer.

All outputs and return values from the invoked procedure are available through the properties or parameters supplied as parameters.

Parameters:

pcCallName INPUT CHARACTER

Name of an external or internal procedure or function to be invoked.

pcTarget INPUT CHARACTER

The name of a manager procedure, the filename of a relatively or absolutely pathed procedure, or an integer value that evaluates to a procedure handle. If the value of this parameter is "" or ?, by default, pcCallName contains the name of a procedure that is to be run nonpersistently.

The parameter is optional. If nothing is specified, then "" or ? is passed.

pcTargetFlags INPUT CHARACTER

This parameter can contain modifiers that are used to invoke the persistent procedure. A modifier can be a valid combination of the following:

P(ersistent) — Indicates that a new instance of the procedure should be instantiated persistently and left running.
A(DM2) — Indicates that a new instance of an ADM2 procedure should be invoked persistently and the initializeObject internal procedure called to initialize it. The ADM2 procedure is left running after the call is complete.
S(ingle) — Indicates that a new instance of the procedure should be instantiated if a running version is not found and left running.
K(ill) — Indicates that if a procedure was instantiated during the call, it should be deleted before control is returned.

The default is to apply the behavior of the S parameter. That is, a persistent procedure is started if it is not found by walking the procedure stack and left running after the call is complete.

You can specify any of the P, A, or S modifiers in combination with K to shut down the procedure. For example, PK instructs the caller to instantiate a new instance of the procedure persistently and delete it when it is complete.

The parameter is optional. If nothing is specified, then "" is passed.

pcCallParmString INPUT CHARACTER

A string that contains the parameters to pass to the procedure or function that is being invoked. The string is a comma-separated list of parameters. Each parameter is a string consisting of space-delimited values in the form "mode data type parameter" where:

mode is one of INPUT, OUTPUT, INPUT-OUTPUT, or OUTPUT-APPEND.
data type is one of CHARACTER, DATE, LOGICAL, INTEGER, DECIMAL, RAW, HANDLE, or ROWID.
parameter is the name of either a property that was previously set using setPropertyList or setSessionParam, or a single quoted constant. If a property is specified, the procedure attempts to evaluate the property value by calling getPropertyList. If no property is available, or Dynamics is not running, a call is made to getSessionParam for the property value. If neither call succeeds, the unknown value is passed.

If the mode of the parameter is either OUTPUT or INPUT-OUTPUT, the property that is specified contains the output value from the call after the call is complete.

The parameter is optional. If nothing is specified, then "" or ? is passed.

Notes:

Once the procedure finishes executing, all temporary handles are deleted and the ttCall record no longer exists for the call. As a result, the Dynamics Call Wrapper has no information about this call so that there are no memory leaks created by calling callstring.p.
If the mode of the parameter is OUTPUT or INPUT-OUTPUT and a property that was set using setPropertyList is specified, the value of the property is set on the server side. It is not synchronized with the client unless the entire call is executed on the client side.